๐Ÿ“บ 4. ์Šคํ”„๋ง ๋นˆ๊ณผ ์˜์กด๊ด€๊ณ„

@Seongukbaek Posted January 05, 2022 ยท Updated January 05, 2022 ยท 9 min read

์Šคํ”„๋ง ์ž…๋ฌธ - ์ฝ”๋“œ๋กœ ๋ฐฐ์šฐ๋Š” ์Šคํ”„๋ง ๋ถ€ํŠธ, ์›น MVC, DB ์ ‘๊ทผ ๊ธฐ์ˆ ์„ ๋“ค์œผ๋ฉฐ ์ •๋ฆฌํ•˜๋Š” POST์ž…๋‹ˆ๋‹ค.

์ „์ฒด์ ์ธ ํ๋ฆ„

  • Spring Project ์ƒ์„ฑ
  • Spring boot๋กœ ์›น ์„œ๋ฒ„ ์‹คํ–‰
  • ํšŒ์› ๋„๋ฉ”์ธ ๊ฐœ๋ฐœ
  • ์›น MVC ๊ฐœ๋ฐœ
  • DB ์—ฐ๋™ - JDBC, JPA, Spring data JPA
  • ํ…Œ์ŠคํŠธ ์ผ€์ด์Šค ์ž‘์„ฑ

์Šคํ”„๋ง ๋นˆ์„ ๋“ฑ๋กํ•˜๋Š” ๋ฐฉ๋ฒ•

  1. ์ปดํฌ๋„ŒํŠธ ์Šค์บ”๊ณผ ์ž๋™ ์˜์กด๊ด€๊ณ„ ์„ค์ •
  2. ์ž๋ฐ” ์ฝ”๋“œ๋ฅผ ์ด์šฉํ•œ ์ง์ ‘ ๋“ฑ๋ก

๐Ÿ” ์ปดํฌ๋„ŒํŠธ ์Šค์บ”๊ณผ ์ž๋™ ์˜์กด๊ด€๊ณ„ ์„ค์ •

์ด์ „ ์‹œ๊ฐ„๊นŒ์ง€ ์ƒ์„ฑํ•œ Member๊ฐ€ ์„œ๋น„์Šค๋ฅผ ์ด์šฉํ•˜๊ธฐ ์œ„ํ•ด์„œ๋Š” Service, Controller ๊ฐ„ ์˜์กด์„ฑ์ด ํ•„์š”ํ•˜๋‹ค.

โ› MemberController ์ƒ์„ฑ

controller/MemberController

import org.springframework.stereotype.Controller; @Controller public class MemberController { }
  • ์ด๋ ‡๊ฒŒ @Controller ๋ฅผ ์‚ฌ์šฉํ•ด ์•„๋ฌด ์ฝ”๋“œ๊ฐ€ ์—†๋Š” controller๋ฅผ ์ƒ์„ฑํ•˜๊ฒŒ ๋˜๋ฉด, ์Šคํ”„๋ง ์ปจํ…Œ์ด๋„ˆ์— MemberController ๋ผ๋Š” ๊ฐ์ฒด๊ฐ€ ์ƒ์„ฑ๋˜์–ด ๊ด€๋ฆฌ๋œ๋‹ค.

= Spring Bean์ด ๊ด€๋ฆฌ๋œ๋‹ค๊ณ  ํ‘œํ˜„, ์ด๊ณณ์—์„œ ์Šคํ”„๋ง ์ปจํ…Œ์ด๋„ˆ์˜ ๊ตฌ์กฐ๋ฅผ ํ™•์ธํ•  ์ˆ˜ ์žˆ๋‹ค.

private final MemberService memberService = new MemberService();
  • Controller์—์„œ, new ๋ฅผ ์ด์šฉํ•˜์—ฌ ๊ฐ์ฒด๋ฅผ ์ƒ์„ฑํ•ด ์‚ฌ์šฉํ•  ์ˆ˜๋„ ์žˆ์ง€๋งŒ, ์Šคํ”„๋ง์ด ๊ด€๋ฆฌํ•˜๊ธฐ ๋•Œ๋ฌธ์— ์ปจํ…Œ์ด๋„ˆ์— ๋“ฑ๋กํ•˜๊ณ  ์ด๋กœ๋ถ€ํ„ฐ ๋ฐ›์•„์„œ ์‚ฌ์šฉํ•˜๋„๋ก ๋ฐ”๊ฟ”์•ผ ํ•œ๋‹ค.

    • ๋‹ค๋ฅธ code์—์„œ๋„ ๋™์ผ ์„œ๋น„์Šค ๊ฐ์ฒด๋ฅผ ์—ฌ๋Ÿฌ ๋ฒˆ ์ƒ์„ฑํ•˜์—ฌ ์‚ฌ์šฉํ•˜๋Š” ๊ฒƒ์€ ๋ถˆํ•„์š”ํ•˜๊ธฐ ๋•Œ๋ฌธ์ด๋‹ค.
@Autowired public MemberController(MemberService memberService) { this.memberService = memberService; }
  • ์ƒ์„ฑ์ž๋ฅผ ์ด์šฉํ•˜์—ฌ ์Šคํ”„๋ง ์ปจํ…Œ์ด๋„ˆ์— ์—ฐ๊ฒฐํ•œ๋‹ค.

์ด๋•Œ, @Autowired ๋ฅผ ์ด์šฉํ•˜๋Š”๋ฐ, ์ด๋Š” ํ˜ธ์ถœ๋œ ์ƒ์„ฑ์ž์˜ ํŒŒ๋ผ๋ฏธํ„ฐ์™€ ์Šคํ”„๋ง ์ปจํ…Œ์ด๋„ˆ๋ฅผ ์—ฐ๊ฒฐ์‹œ์ผœ์ค€๋‹ค. ์œ„์˜ ์˜ˆ์ œ์—์„œ๋Š” ์Šคํ”„๋ง ์ปจํ…Œ์ด๋„ˆ์— ์žˆ๋Š” MemberService ์™€ ์—ฐ๊ฒฐ์„ ์ˆ˜ํ–‰ํ•œ๋‹ค.

์‹คํ–‰์„ ํ•˜๊ฒŒ ๋˜๋ฉด

Parameter 0 of constructor in hello.hellospring.controller.MemberController required a bean of type 'hello.hellospring.service.MemberService' that could not be found.

์œ„์™€ ๊ฐ™์ด MemberService ๋ฅผ ์ฐพ์„ ์ˆ˜ ์—†๋‹ค๋Š” ์—๋Ÿฌ๊ฐ€ ๋ฐœ์ƒํ•œ๋‹ค.

์ด๋Ÿฌํ•œ ์ด์œ ๋Š”, ์ด์ „์— ์ž‘์„ฑํ•œ MemberService ๋Š” ์ˆœ์ˆ˜ํ•œ Java ์ฝ”๋“œ์ด๋ฏ€๋กœ, ์Šคํ”„๋ง์ด ์ด๋ฅผ ์ธ์‹ํ•  ๋ฐฉ๋ฒ•์ด ์—†๋‹ค.

@Service public class MemberService

๋”ฐ๋ผ์„œ ์Šคํ”„๋ง ์ปจํ…Œ์ด๋„ˆ๊ฐ€ ํ•ด๋‹น Service๋ฅผ ์ธ์‹ํ•˜๊ณ  ๋“ฑ๋กํ•  ์ˆ˜ ์žˆ๋„๋ก @Service annotation์„ ์‚ฌ์šฉํ•œ๋‹ค.

๋˜ํ•œ ์ „์ฒด์ ์œผ๋กœ ๋ณด์•˜์„๋•Œ, Controller class - ์™ธ๋ถ€ ์š”์ฒญ์„ ๋ฐ›์Œ - @Controller, Test class - @SpringBootTest, Repository class - Data ์ €์žฅ - @Repository, Service class - ๋น„์ฆˆ๋‹ˆ์Šค ๋กœ์ง ์ƒ์„ฑ - @Service

๋‹ค์Œ๊ณผ ๊ฐ™์ด ๊ฐ annotation์„ ์‚ฌ์šฉํ•˜์—ฌ ์Šคํ”„๋ง์ด ๋™์ž‘ํ•  ๋•Œ, ์ปจํ…Œ์ด๋„ˆ์— ๋“ฑ๋กํ•˜๋Š” ๊ฒƒ์„ ํ™•์ธํ•  ์ˆ˜ ์žˆ๋‹ค.

์ •ํ˜•ํ™”๋œ ํŒจํ„ด!

์˜์กด ๊ด€๊ณ„ ์ฃผ์ž… (Dependency Injection) : Controller ์ƒ์„ฑ์ž์— @Autowired ๋ฅผ ์‚ฌ์šฉํ•ด ์—ฐ๊ฒฐ์„ ์ˆ˜ํ–‰

  • controller๊ฐ€ ์ƒ์„ฑ๋  ๋•Œ, ์Šคํ”„๋ง ๋นˆ์— ์žˆ๋Š” ๊ฐ์ฒด๋ฅผ ๊ฐ€์ ธ๋‹ค ์—ฐ๊ฒฐ์— ์‚ฌ์šฉ = Dependency Injection(์˜์กด์„ฑ ์ฃผ์ž…)

MemberService.java

@Autowired public MemberService(MemberRepository memberRepository) { this.memberRepository = memberRepository; }
  • MemberService ๋˜ํ•œ MemberRepository ๋ฅผ ์‚ฌ์šฉํ•˜๋Š” @Service ์ด๋ฏ€๋กœ, @Autowired annotation์„ ์ด์šฉํ•œ๋‹ค.
  • ์ด๋ฅผ ํ†ตํ•ด ์Šคํ”„๋ง ์ปจํ…Œ์ด๋„ˆ๋กœ๋ถ€ํ„ฐ MemberRepository ๋ฅผ ์ฃผ์ž…๋ฐ›๋Š”๋‹ค.

์ปดํฌ๋„ŒํŠธ ์Šค์บ”์ธ ์ด์œ 
@Component ๋ฅผ ์ด์šฉํ•˜์—ฌ ์˜์กด ๊ด€๊ณ„๋ฅผ ๋ช…์‹œํ•˜๊ณ  ๋“ฑ๋กํ•˜๋Š” ๋ฐฉ์‹์ด๋‹ค. ํ•˜์ง€๋งŒ ์šฐ๋ฆฌ๊ฐ€ ์ž‘์„ฑํ•œ class๋“ค์˜ Annotation์„ ๋ณด๋ฉด, class์— ๋Œ€ํ•ด @Service , @Controller , @Repository ๋“ฑ์„ ์‚ฌ์šฉํ•œ๋‹ค.

๊ทธ๋Ÿผ ์™œ @Service ์™€ ๊ฐ™์ด @Component ๋ผ๊ณ  ๋ช…์‹œํ•˜์ง€ ์•Š์•„๋„ ์‚ฌ์šฉ์ด ๊ฐ€๋Šฅํ• ๊นŒ ?

  • @Service ์— command + click ํ•ด๋ณด๋ฉด, ์•„๋ž˜์™€ ๊ฐ™์ด @Component ๊ฐ€ ๋ช…์‹œ๋˜์–ด ์žˆ๋Š” ๊ฒƒ์„ ํ™•์ธํ•  ์ˆ˜ ์žˆ๋‹ค.
@Target({ElementType.TYPE}) @Retention(RetentionPolicy.RUNTIME) @Documented @Component public @interface Service { /** * The value may indicate a suggestion for a logical component name, * to be turned into a Spring bean in case of an autodetected component. * @return the suggested component name, if any (or empty String otherwise) */ @AliasFor(annotation = Component.class) String value() default ""; }

์•„๋ž˜๋Š” ์œ„์—์„œ ์„ค๋ช…ํ•œ Controller, Service, Repository ๋ฅผ ํฌํ•จํ•˜๋Š” ์Šคํ”„๋ง ์ปจํ…Œ์ด๋„ˆ์˜ ๊ตฌ์กฐ๋ฅผ ๊ฐ„๋žตํ•˜๊ฒŒ ํ‘œํ˜„ํ–ˆ๋‹ค.

์ด๋ ‡๊ฒŒ @Component annotation์ด ์‚ฌ์šฉ๋œ ๊ฒฝ์šฐ, ์Šคํ”„๋ง์ด ๋™์ž‘ํ•  ๋•Œ ์ด๋“ค์„ ๋ชจ๋‘ ๊ฐ์ฒด ๋กœ ์ƒ์„ฑํ•˜์—ฌ ์Šคํ”„๋ง ์ปจํ…Œ์ด๋„ˆ์— ์ž๋™ ๋“ฑ๋ก๋œ๋‹ค. (=์Šคํ”„๋ง ๋นˆ์œผ๋กœ ์ž๋™ ๋“ฑ๋ก)

  • ์œ„ ์˜ˆ์‹œ์—์„œ๋Š” helloController , memberService , memberRepository ๊ฐ€ ๊ฐ์ฒด๋กœ ์ƒ์„ฑ๋˜์–ด ๋“ฑ๋ก๋œ๋‹ค.
  • ๊ทธ๋ฆฌ๊ณ , @Autowired annotation์€ ๋“ฑ๋ก๋œ ๊ฐ์ฒด๊ฐ„์˜ ์—ฐ๊ด€๊ด€๊ณ„๋ฅผ ์˜๋ฏธํ•œ๋‹ค.

๊ทธ๋Ÿผ ์•„๋ฌด class์—์„œ Annotation์„ ๋ช…์‹œํ•˜๋ฉด ์Šคํ”„๋ง ์ปจํ…Œ์ด๋„ˆ์— ์ž๋™ ๋“ฑ๋ก๋ ๊นŒ ? ์ •๋‹ต์€ ๊ธฐ๋ณธ์ ์œผ๋กœ๋Š” ์šฐ๋ฆฌ๊ฐ€ ์‹คํ–‰ํ•˜๋Š” HelloSpringApplication ์˜ package ์˜ ์œ„์น˜์— ๋”ฐ๋ผ ๊ฒฐ์ •๋œ๋‹ค.

  • ํ•ด๋‹น package์™€ ๋™์ผํ•˜๊ฑฐ๋‚˜ ํ•˜์œ„ package์— ํฌํ•จ๋˜์–ด ์žˆ๋Š” ๊ฒฝ์šฐ, ์Šคํ”„๋ง์ด ๋ชจ๋‘ ์ฐพ์•„ ์Šคํ”„๋ง ๋นˆ์œผ๋กœ ์ปดํฌ๋„ŒํŠธ ์Šค์บ”์„ ์ˆ˜ํ–‰ํ•œ๋‹ค.

์ฐธ๊ณ  ์Šคํ”„๋ง์€ ์Šคํ”„๋ง ์ปจํ…Œ์ด๋„ˆ์— ์Šคํ”„๋ง ๋นˆ์„ ๋“ฑ๋กํ•  ๋•Œ, ์‹ฑ๊ธ€ํ†ค์œผ๋กœ ๋“ฑ๋กํ•œ๋‹ค. (default)

  • ์‹ฑ๊ธ€ํ†ค: ์œ ์ผํ•˜๊ฒŒ ํ•˜๋‚˜๋งŒ ๋“ฑ๋กํ•˜์—ฌ ์ด๋ฅผ ๊ณต์œ ํ•œ๋‹ค. ์ด๋ ‡๊ฒŒ ๋˜๋ฉด, ๊ฐ™์€ ์Šคํ”„๋ง ๋นˆ์ธ ๊ฒฝ์šฐ ๋ชจ๋‘ ๊ฐ™์€ instance๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ๊ฒƒ์ด๋ฏ€๋กœ, ๋ฉ”๋ชจ๋ฆฌ๋ฅผ ์ ˆ์•ฝํ•  ์ˆ˜ ์žˆ๋‹ค.

๐Ÿ” ์ž๋ฐ” ์ฝ”๋“œ๋กœ ์ง์ ‘ ์Šคํ”„๋ง ๋นˆ ๋“ฑ๋กํ•˜๊ธฐ

๋จผ์ €, ์ง์ ‘ ์ฝ”๋“œ๋กœ ๋“ฑ๋กํ•˜๊ธฐ ์œ„ํ•ด ์œ„์—์„œ ์‚ฌ์šฉํ–ˆ๋˜ ์ปดํฌ๋„ŒํŠธ ์Šค์บ” ์ฝ”๋“œ๋ฅผ ์‚ญ์ œํ•œ๋‹ค. (์ด๋•Œ Controller ๋Š” ์‚ญ์ œํ•˜์ง€ ์•Š๊ณ  ๊ทธ๋Œ€๋กœ ๋‘”๋‹ค.)

Controller ๋Š” ์–ด์ฐจํ”ผ ์Šคํ”„๋ง์ด ๊ด€๋ฆฌํ•˜๊ธฐ ๋•Œ๋ฌธ์— ๊ทธ๋ƒฅ ์ปดํฌ๋„ŒํŠธ ์Šค์บ” ๋ฐฉ์‹์„ ๊ทธ๋Œ€๋กœ ์‚ฌ์šฉํ•œ๋‹ค.

์ดํ›„ ์‹คํ–‰์„ ํ•˜๊ฒŒ ๋˜๋ฉด, ์Šคํ”„๋ง ๋นˆ์— ๋“ฑ๋ก๋œ ๊ฐ์ฒด๊ฐ€ ์—†์œผ๋ฏ€๋กœ, ์—๋Ÿฌ๊ฐ€ ๋ฐœ์ƒํ•œ๋‹ค.

์ด์ œ ์ง์ ‘ ๋“ฑ๋ก์„ ์œ„ํ•ด HelloSpringApplication ๊ณผ ๊ฐ™์€ ์œ„์น˜์— SpringConfig class๋ฅผ ์ƒ์„ฑํ•œ๋‹ค.

@Configuration public class SpringConfig { @Bean public MemberService memberService() { return new MemberService(); } }
  • @Bean annotation์€ ์Šคํ”„๋ง ๋นˆ์„ ๋“ฑ๋กํ•œ๋‹ค๋Š” ๊ฒƒ์„ ๋ช…์‹œํ•œ๋‹ค.
  • ์Šคํ”„๋ง์ด ๋™์ž‘ํ•  ๋•Œ, @Configuration ์„ ์ฝ์œผ๋ฉด

    • @Bean ์„ ์ฐพ์•„ ํ•ด๋‹น ๋กœ์ง์„ ํ˜ธ์ถœํ•˜์—ฌ ์ด๋ฅผ ์Šคํ”„๋ง ๋นˆ์œผ๋กœ ๋“ฑ๋กํ•œ๋‹ค.
  • ์œ„์˜ ์ฝ”๋“œ๋Š” ์—๋Ÿฌ๊ฐ€ ๋œจ๋Š”๋ฐ, ํ•ด๊ฒฐํ•˜๊ธฐ ์œ„ํ•ด์„œ ์ƒ์„ฑ์ž์—์„œ์˜ ์ถ”๊ฐ€๊ฐ€ ํ•„์š”ํ•˜๋‹ค.
@Bean public MemberService memberService() { return new MemberService(memberRepository()); } @Bean public MemberRepository memberRepository() { return new MemoryMemberRepository(); }
  • MemberService ๋Š” MemberRepository ๊ฐ€ ํ•„์š”ํ•˜๋‹ค.
  • ๋จผ์ €, MemberService ๋ฅผ ์Šคํ”„๋ง ๋นˆ์— ๋“ฑ๋กํ•œ ๊ฒƒ๊ณผ ๋™์ผํ•˜๊ฒŒ MemberRepository ๋˜ํ•œ ๋“ฑ๋กํ•œ๋‹ค.
  • ๊ทธ๋ฆฌ๊ณ  ๋“ฑ๋ก๋œ MemberRepository ๋ฅผ MemberService ์— ์ „๋‹ฌํ•œ๋‹ค.

์‹คํ–‰ํ–ˆ์„ ๋•Œ ๋ฌธ์ œ ์—†์ด ์ž˜ ๋™์ž‘ํ•œ๋‹ค.

DI(Dependency Injection) ์—๋Š” 3๊ฐ€์ง€ ๋ฐฉ๋ฒ•์ด ์žˆ๋‹ค.

  • Field Injection : ๊ณ ์ •์ ์ธ ๋ฐฉ๋ฒ•, ์ˆ˜์ •์ด ๋ถˆ๊ฐ€๋Šฅ
@Autowired private MemberService memberService;
  • Setter Injection : Setter๋ฅผ ํ†ตํ•ด ์ฃผ์ž…, ์ƒ์„ฑ ๋”ฐ๋กœ ์ฃผ์ž… ๋”ฐ๋กœ, setter๊ฐ€ publicํ•˜๊ฒŒ ๋…ธ์ถœ๋˜์–ด ์œ„ํ—˜ํ•  ์ˆ˜ ์žˆ๋‹ค.
private MemberService memberService; // final ์ œ๊ฑฐ @Autowired public void setMemberService(MemberService memberService) { this.memberService = memberService; }
  • Constructor Injection : ๊ฐ€์žฅ ๊ถŒ์žฅ, ์˜์กด๊ด€๊ณ„๊ฐ€ ์‹คํ–‰ ์ค‘์— ๋™์ ์œผ๋กœ ๋ณ€๊ฒฝ๋˜๋Š” ๊ฒฝ์šฐ๋Š” ๊ฑฐ์˜ ์—†๊ธฐ ๋•Œ๋ฌธ์ด๋‹ค.
public MemberController(MemberService memberService) { this.memberService = memberService; }

โ‡ข ํ•ด๋‹น ์˜ˆ์ œ์—์„œ๋Š” ๋ฐ์ดํ„ฐ ์ €์žฅ์†Œ๊ฐ€ ์„ ์ •๋˜์ง€ ์•Š์•„ MemoryMemberRepository ๋ฅผ ์‚ฌ์šฉํ•˜๊ธฐ ๋•Œ๋ฌธ์—, ์„ค์ •(SpringConfig)์„ ํ†ตํ•ด ์Šคํ”„๋ง ๋นˆ์œผ๋กœ ๋“ฑ๋กํ•ด์•ผ ํ•œ๋‹ค.


๐Ÿ“Œ ์ค‘์š”ํ•œ ๊ฐœ๋…

์˜์กด์„ฑ ์ฃผ์ž…

๐Ÿ“• ์ฐธ๊ณ 

@Seongukbaek
๋ฐฐ์šฐ๊ณ  ์ •๋ฆฌํ•˜๊ณ  ๊ณต์œ ํ•˜๋Š” ๋Œ€ํ•™์ƒ ๋ฐฑ์„ฑ์šฑ์ž…๋‹ˆ๋‹ค ๐Ÿ˜€